Skip to content

docs: add module docstrings and improve method docstrings in profiles package#292

Merged
Jammy2211 merged 1 commit intomainfrom
docs/profiles
Mar 11, 2026
Merged

docs: add module docstrings and improve method docstrings in profiles package#292
Jammy2211 merged 1 commit intomainfrom
docs/profiles

Conversation

@Jammy2211
Copy link
Copy Markdown
Collaborator

Summary

  • Add module-level docstrings to geometry_profiles, light/abstract, light/standard/sersic, light/linear/abstract, light/operated/abstract, mass/abstract/abstract, and basis modules
  • Add class docstring to LightProfileOperated explaining the operated-only filtering pattern
  • Add full docstrings to abstract MassProfile methods (deflections_yx_2d_from, convergence_2d_from, potential_2d_from, convergence_func, potential_func, mass_integral, ellipticity_rescale) including lensing physics context
  • Add docstring to deflections_2d_via_potential_2d_from explaining the finite-difference fallback
  • Improve GeometryProfile.has(), LightProfile.coefficient_tag, half_light_radius, _intensity docstrings

Test plan

  • Confirm Sphinx docs build without errors
  • Verify docstring text renders correctly in generated HTML

🤖 Generated with Claude Code

… package

- Add module-level docstrings to geometry_profiles, light/abstract,
  light/standard/sersic, light/linear/abstract, light/operated/abstract,
  mass/abstract/abstract, and basis explaining what each module contains
- Add class docstring to LightProfileOperated explaining the operated-only
  filtering pattern used throughout the codebase
- Add docstrings to abstract MassProfile methods (deflections_yx_2d_from,
  convergence_2d_from, potential_2d_from, convergence_func, potential_func,
  mass_integral, ellipticity_rescale) including the lensing physics context
- Add deflections_2d_via_potential_2d_from docstring explaining the
  finite-difference fallback implementation
- Improve GeometryProfile.has() docstring with Parameters/Returns sections
- Add docstrings to GeometryProfile abstract transform methods
- Add docstrings to LightProfile.coefficient_tag, half_light_radius, _intensity

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@Jammy2211 Jammy2211 merged commit 91c39d6 into main Mar 11, 2026
8 checks passed
@Jammy2211 Jammy2211 deleted the docs/profiles branch April 2, 2026 11:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant